home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xteddy / xteddy.README < prev   
Encoding:
Text File  |  1995-05-03  |  4.1 KB  |  105 lines
  1. ----------------------------------------------------------------------
  2. xteddy version 1.0, by Stefan Gustavson, ISY-LiTH (stefang@isy.liu.se)
  3. ----------------------------------------------------------------------
  4.  
  5. DESCRIPTION
  6.  
  7. xteddy is a cuddly teddy bear for your X Windows desktop.
  8.  
  9. Normally, xteddy just sits around doing nothing. After all, that's what
  10. teddy bears are for. Look at him, talk to him, place heavy windows on
  11. top of him, zap him around until he becomes dizzy, do what you like;
  12. he will always be your true (albeit virtual) friend.
  13.  
  14. You can move xteddy with the mouse by pointing at him and dragging
  15. him around. When clicked upon, he will pop up on top of all other
  16. windows. If you type "q" on him, he will die (or, as I like to think
  17. of it, be tucked away in the file system until you need him next time).
  18.  
  19. That's it. But he's cute.
  20.  
  21.  
  22. COMPILATION
  23.  
  24. You will need the shape extension to X and the Xpm library to compile.
  25. The shape extension to X is bundled with most distributions of X.
  26. The Xpm library can be obtained by anonymous FTP to avahi.inria.fr
  27. or to export.lcs.mit.edu. The Imakefile will need some editing to point
  28. to the place where Xpm is installed at your site. Then, just execute
  29. "xmkmf" and "make xteddy".
  30.  
  31. If you don't have access to Xpm, you can compile with -DNOXPM, which
  32. makes Xteddy always show up in black-and-white. If you don't have the
  33. shape extension either, you can hack the source code to skip the window
  34. shaping, but then Xteddy will only be a square window with a small teddy
  35. bear locked up inside, which is not what I intended. I refuse to provide
  36. a compilation flag for this.
  37.  
  38. By default, xteddy will set the override_redirect attribute for his
  39. window, which means that he will be ignored by most window managers
  40. and live directly on the root window all by himself.
  41. You cannot iconify or resize him. This is intentional. If you really
  42. want to be able to iconify xteddy, there is code to communicate with
  43. a window manager. All it takes is that you compile with -DUSEWM.
  44. Beware that this will cram title bars and other ugly things onto xteddy.
  45. If you specify -DUSEWM, you should tell your window manager not to
  46. decorate the window. To find out how to do that, refer to the manual of
  47. your specific window manager.
  48.  
  49.  
  50. YOUR OWN TEDDY
  51.  
  52. It's quite easy to make your own favourite teddy bear for the program.
  53. You will need to change four files that are included at compile time.
  54. The files xteddy_bw.xbm and xteddy_mask.xbm are standard X bitmap
  55. files. The color and grayscale images are in X Pixmap format as written
  56. by the converter ppmtoxpm supplied with the Xpm library. The same shape
  57. mask is used for monochrome, grayscale and color. See to it that you get
  58. the names right for the variables at the top of the file. The size does
  59. not really matter, as long as it is the same for all four files.
  60.  
  61.  
  62. BUGS
  63.  
  64. The code for xteddy is far from bullet-proof. It might fail for some
  65. X servers, and there are doubtlessly some bugs I have not found.
  66.  
  67. This README file is all there is for a manpage.
  68.  
  69. Xteddy reads no options from the command line, and does not make use
  70. of the X resource database. I just didn't get around to that.
  71. The compilation flag -DUSEWM should really be a command-line option.
  72.  
  73.  
  74. CHANGES
  75.  
  76. Version 1.0 of xteddy is the original release. It is a fast hack made
  77. for fun. If you make any useful changes, additions, improvements, or bug
  78. fixes, please send me a message. If you like xteddy, remember to smile.
  79.  
  80.  
  81. COPYRIGHT
  82.  
  83. Copyright Stefan Gustavson, ISY-LiTH, 1994.
  84.   Email address: stefang@isy.liu.se
  85.  
  86. You may use, copy, modify, and distribute this software and its
  87. rudimentary documentation freely, provided that you do it for free
  88. and that the above copyright notice appears in all copies and sup-
  89. porting documentation.
  90.  
  91. The Xpm library is Copyright 1990-93 GROUPE BULL.
  92. The X Window System is Copyright the Massachusetts Institute
  93. of Technology. "X Window System" is a trademark of MIT.
  94. The teddy bear images are photos of a Tender Teddy from Gund.
  95.  
  96.  
  97. DISCLAIMER
  98.  
  99. I make no promises that this software will work for any purpose
  100. whatsoever. If you hurt yourself or your system, don't blame me.
  101. Blame xteddy if you like. He doesn't mind.
  102.  
  103.  
  104. ---- This file wast last modified on Jan 20, 1994 ----
  105.